RtcplStopSubsystemComponent

The function RtcplStopSubsystemComponent stops a specified RTX Subsystem component.

Syntax

BOOL RtcplStopSubsystemComponent(
    DWORD Component,
    BOOL Force
);

Parameters

Component

One of the following user components:

Value Description

COMPONENT_SUBSYSTEM

All components of RTX subsystem

COMPONENT_TCPIP

RT-TCP/IP Stack

COMPONENT_SERVER

RtxServer

COMPONENT_RTX_RTSS

RTX RTSS driver

COMPONENT_HAL_EXT

HAL Extension driver

Force

Specifies how the function behaves if an application depends on Component:

Value Description

GENERAL_ENABLE

Automatically stops any applications that depend on the component you want to stop.

GENERAL_DISABLE

Any running dependent processes will fail the request.

Return Values

TRUE if the function succeeds, otherwise FALSE is returned

Remarks

If stopping a service fails because of dependencies, but no RTSS applications are running, the failure is probably due to a Windows application linked to RTX.

RtcplStopSubsystemComponent stops RTX drivers and services in the following order:

  1. Run through process slots
  2. TCP/IP Stack, if enabled
  3. RtxServer
  4. Rtx_Rtss
  5. RTX HAL extension

Related RTX Properties Control Panel Features

Tab

Control tab

Feature(s)

Stop RTX button

Requirements

Header RtxProp.h
Library RtxProp.lib
IntervalZero.com | Support | Give Feedback